home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-06 / jsdemo.zip / DEMOREAD.ME < prev    next >
Text File  |  1991-04-13  |  31KB  |  664 lines

  1.  
  2.                BobWare Job Server For Novell NetWare 2.1x
  3.  
  4.    Copyright (c) 1990 by Campbell's Software Inc.  All Rights Reserved.
  5.  
  6.  
  7.  
  8.  
  9. INTRODUCTION:
  10.  
  11.   This is a fully functional demonstration of a Job Server system based
  12.   on Novell's Queue Management APIs.  While the system is fully functional,
  13.   it is not the "real" system.  The only difference is that the program JSCON
  14.   is replaced by JSDEMO, which displays annoying demo disclaimers.  Feel free
  15.   to install, use, and distribute this software, keeping in mind the intent is
  16.   for you to use it during a limited demonstration period not to exceed 90
  17.   days.  Information is included at the end of this document that will allow
  18.   you to obtain a licensed copy of this software through Campbell's
  19.   Software Inc.  Use of this software after 90 days without the proper
  20.   licensing agreement is strictly forbidden.
  21.  
  22.   All of the following documentation, terms and definitions, are meant to
  23.   apply to this particular implementation of a job server for NetWare 2.1x
  24.   networks and DOS 3.x workstations.
  25.  
  26.  
  27. CONCEPTS:
  28.  
  29.   A job server is a workstation dedicated to performing DOS command line
  30.   operations for client workstations on the network.
  31.  
  32.   A client is any user logged into the file server where the job server has
  33.   been installed.
  34.  
  35.   A queue user is a client with the authority to place requests in a specific
  36.   queue for processing by a job server.  This authorization can be explicit
  37.   or implied.  Explicit authorization applies to a single user.  Implied
  38.   authorization applies to a group of users.
  39.  
  40.   A job queue is a set of files which identify a queue user's request for
  41.   processing, and information necessary for the job server to complete the
  42.   request in an environment as close as possible to the queue user's, when
  43.   the request was made.
  44.  
  45.   A queue server is a job server with the authority to process requests
  46.   which have been placed in a specific queue by a queue user.
  47.  
  48.   A queue operator is a client with special privileges which allow queue
  49.   maintenance operations to be performed.
  50.  
  51.   A queue job is a single request for processing and it's associated files.
  52.  
  53.   A queue log is a set of files which records the history of queue's activity
  54.   and the results of queue job processing.
  55.  
  56.  
  57.   There are four main functions required for the job server system:
  58.  
  59.       1)  A queue user makes a request for processing by creating
  60.           a queue job and placing it in a queue.
  61.  
  62.       2)  A queue server polls it's assigned queues looking for jobs
  63.           to be processed.  When a job is identified for processing
  64.           the queue server creates a DOS and NetWare environment as
  65.           close as possible to the queue user's when the request was
  66.           made.  This includes DOS environment variables, network drive
  67.           mappings, and NetWare security.  The request is processed
  68.           and a queue log entry is posted.  The log entry contains
  69.           information on the job's completion status and as much video
  70.           output that could be captured while the request was being
  71.           processed.  (See TECHNICAL INFORMATION below)
  72.  
  73.       3)  While a job is in the queue it is monitored and maintained
  74.           through a job server console program.
  75.  
  76.       4)  Following it's completion a queue job's log entry is accessed
  77.           and maintained through the same job server console program
  78.           mentioned above.  A queue user has access to only his or her
  79.           log entries.  A queue operator has access to all log entries.
  80.  
  81.   All queue job monitoring and maintenance is performed through the JSCON
  82.   utility and can be performed from any workstation logged into the file
  83.   server where the job queue resides.
  84.  
  85.  
  86. BENEFITS:
  87.  
  88.   Using a job server to execute requests has several benefits in a network
  89.   environment.  The following is a list of a few that immediately come to
  90.   mind.  We hope you will identify more.  If you do please let us know.
  91.  
  92.   1) Submitting programs for execution on the dedicated job server frees
  93.      your workstation for other activities.  This can be quite beneficial
  94.      if you have programs that run for a significant amount of time.
  95.  
  96.   2) Programs that require special hardware resources (a 386, additional
  97.      memory, a math coprocessor, etc.) can be submitted from any workstation,
  98.      but will have the hardware resources of the job server available when
  99.      they execute.
  100.  
  101.   3) Programs can be scheduled to run at a specific time on a daily or
  102.      weekly basis.  This allows routine programs to be run automatically
  103.      on the job server.
  104.  
  105.  
  106.  
  107. KEYBOARD CONVENTIONS:
  108.  
  109.   <Esc>         - allows you to backup to the previous screen from any
  110.                   location.
  111.  
  112.   <Enter>       - selects or accepts current option or value.
  113.  
  114.   up/down arrow - moves up/down on menus, window displays, and browse files.
  115.  
  116.   <Page Up>     - moves up a "page" at a time on window displays and browse
  117.                   files. Does not currently function on menus.
  118.  
  119.   <Page Down>   - moves down a "page" at a time on window displays and browse
  120.                   files. Does not currently function on menus.
  121.  
  122.   <Home>        - moves to the top of a browse file.
  123.  
  124.   <End>         - moves to the bottom of a browse file.
  125.  
  126.   <F9>          - displays additional user log file options.
  127.  
  128.   <Shift><F7>   - prints log files.
  129.  
  130.   <Delete>      - deletes current selection.
  131.  
  132.   <Insert>      - inserts a new entry.
  133.  
  134.  
  135. SETUP:
  136.  
  137.   Along with this readme file you should have received three (3) programs,
  138.   JSEXEC.EXE, JSCON.EXE, and JSERVER.EXE.   You must be logged into the
  139.   file server on which you are installing the job server as SUPERVISOR, or
  140.   a SUPERVISOR equivalent user.
  141.  
  142.   If you have used Novell's PConsole utility (or any of their other
  143.   "console" utilities) you should be in familiar territory.  Pressing
  144.   <Esc> will back you out of the program from any point.
  145.  
  146.  
  147.   1) Copy JSEXEC.EXE and JSCON.EXE to the SYS:PUBLIC directory of the
  148.      file server on which you are installing the job server.  (These
  149.      programs can also be copied to any directory to which a search
  150.      mapping has been defined).  JSERVER.EXE will be used in the
  151.      INSTALLATION section below.
  152.  
  153.   2) Flag the two (2) programs above SRO.
  154.  
  155.   3) Type JSCON at the DOS prompt and press <Enter>.  A menu titled
  156.      "Available Options" with three selections will be presented.
  157.  
  158.  
  159.   4) Select "Job Server Information" from the menu.  If this a first time
  160.      installation you should be presented with an empty window titled
  161.      "Defined Job Servers".  (If the window is not empty see TECHNICAL
  162.      INFORMATION below before continuing).
  163.  
  164.   5) Press <Insert>.  A horizontal scrolling window will appear.  Enter
  165.      any valid NetWare name for your job server and press <Enter>.  The
  166.      name you entered should now appear in the "Defined Job Servers"
  167.      window.  By repeating this step you can define additional job servers.
  168.  
  169.   6) Select the name of the job server you are installing from the list
  170.      of defined job servers and press <Enter>.  The "Server Information"
  171.      menu will appear.
  172.  
  173.   7) Selecting "Server Full Name" and pressing <Enter> will allow you to
  174.      add a descriptive name up to 127 characters for the job server.
  175.      "Home Directory" is for future use and can be ignored, HOWEVER A DOS
  176.      DIRECTORY MUST BE DEFINED FOR THE JOB SERVER TO OPERATE.
  177.  
  178.   8) Select "DOS Directory" and press <Enter>.  In the horizontal window
  179.      that appears type the full network volume and directory path where the
  180.      version of DOS the job server will boot from is located.  Press <Enter>
  181.      to record your entry.
  182.  
  183.      THIS IS THE DOS DIRECTORY WHICH CORRESPONDS TO THE VERSION OF DOS THE
  184.      DEDICATED WORKSTATION FUNCTIONING AS THE JOB SERVER WILL BOOT FROM.
  185.      THIS MUST BE DEFINED CORRECTLY FOR THE JOB SERVER TO OPERATE.
  186.  
  187.   9) Press <Esc> until you are returned to the main ("Available Options")
  188.      menu.
  189.  
  190.  10) Select "Job Queue Information" from the "Available Options" menu.
  191.      If this a first time installation you should be presented with an
  192.      empty window titled "Defined Job Queues".  (If the window is not empty
  193.      see TECHNICAL INFORMATION below before continuing).
  194.  
  195.  11) Press <Insert>.  A horizontal scrolling window will appear.  Enter
  196.      any valid NetWare name for your job queue and press <Enter>.  The
  197.      name you entered should now appear in the "Defined Job Queues"
  198.      window.  By repeating this step you can define additional job queues.
  199.  
  200.  12) Select the name of the job queue you just defined from the list of
  201.      defined job queues and press <Enter>.  The "Queue Information"
  202.      window will appear.
  203.  
  204.  13) Select "Queue Servers" from the menu.  A list of "Assigned Servers"
  205.      will appear, and should be empty if this is a first time installation.
  206.      (If the window is not empty see TECHNICAL INFORMATION below before
  207.      continuing).
  208.  
  209.  
  210.  14) Press <Insert>.  A list of "Candidate Servers" will appear.  Any job
  211.      servers you defined in step 5 will appear.
  212.  
  213.  15) Select the name of the job server you wish to be assigned to service
  214.      this queue.  More than one job server can service a single queue by
  215.      repeating steps 14 & 15.
  216.  
  217.  16) When you are done assigning job servers to job queues press <Esc> to
  218.      return to the "Queue Information" window.
  219.  
  220.  17) Select "Queue Operators" from the menu.  A list of "Assigned Operators"
  221.      will appear, and should be empty if this is a first time installation.
  222.      (If the window is not empty see TECHNICAL INFORMATION below before
  223.      continuing).
  224.  
  225.  18) Press <Insert>.  A list of "Candidate Operators" will appear.  All
  226.      Netware users and groups are candidates. (If you have a combined total
  227.      of more than 256 users and groups defined to your network see TECHNICAL
  228.      INFORMATION below before continuing).
  229.  
  230.  19) Select the name of the user or group you wish to be assigned as a
  231.      queue operator.  Assign additional users and groups as queue operators
  232.      by repeating steps 18 & 19.  (SUPERVISOR and SUPERVISOR equivalent users
  233.      are not automatically queue operators. You should assign at least one
  234.      queue operator.  Special privileges granted to queue operators are
  235.      discussed in THE QUEUE OPERATOR below).
  236.  
  237.  20) When you are done assigning queue operators press <Esc> to return to
  238.      the "Queue Information" window.
  239.  
  240.  21) Select "Queue Users" from the menu.  A list of "Assigned Users" will
  241.      appear, and should be empty if this is a first time installation.
  242.      (If the window is not empty see TECHNICAL INFORMATION below before
  243.      continuing).
  244.  
  245.  22) Press <Insert>.  A list of "Candidate Users" will appear.  All Netware
  246.      users and groups are candidates. (If you have a combined total of
  247.      more than 256 users and groups defined to your network see TECHNICAL
  248.      INFORMATION below before continuing).
  249.  
  250.  23) Select the name of the user or group you wish to be assigned as a
  251.      queue user.  Assign additional users and groups as queue users by
  252.      repeating steps 22 & 23.  (SUPERVISOR and SUPERVISOR equivalent users
  253.      are not automatically queue users.  You should assign at least one
  254.      queue user.  Only these users will be allowed to place jobs in the
  255.      queue)
  256.  
  257.  24) When you are done assigning queue users press <Esc> until you are
  258.      prompted to confirm exiting the JSCON utility.
  259.  
  260.   Job server setup should now be complete.
  261.  
  262.   Job servers and job queues can be deleted by highlighting the appropriate
  263.   name in the "Defined Job Servers" or "Defined Job Queues" windows,
  264.   respectively.  Then press the <Delete> key and confirm or cancel your
  265.   request.
  266.  
  267.   Queue servers, queue operators, and queue users can be removed from 
  268.   a job queue in a similar manner from the "Assigned Servers", "Assigned
  269.   Operators", and "Assigned Users" windows.
  270.  
  271.  
  272.  
  273. INSTALLATION:
  274.  
  275.   1) Create a bootable diskette with the version of DOS you entered for
  276.      "DOS Directory" in step 8 of SETUP.  This will be the Job Server
  277.      boot diskette.
  278.  
  279.   2) Create a CONFIG.SYS with appropriate entries for processing the
  280.      job server will be required to do.
  281.  
  282.      The CONFIG.SYS file should be almost identical to the CONFIG.SYS
  283.      used on queue user workstations, however the job server will load
  284.      an additional COMMAND.COM and open two (2) files while processing
  285.      jobs.  This could require additional DOS environment space and an
  286.      increase in the FILES=nn entry in CONFIG.SYS.  See your DOS manual
  287.      for more information on these entries.
  288.  
  289.   3) Load the appropriate NetWare shell files (IPX.COM & NET3.COM) on the
  290.      job server boot diskette.  These should correspond to the Network
  291.      Interface Card installed in the dedicated workstation acting as the
  292.      job server.
  293.  
  294.      You should also place any device drivers the job server might require
  295.      on the job server boot diskette. (e.g ANSI.SYS).
  296.  
  297.   4) Copy the JSERVER.EXE file to the job server boot diskette.
  298.  
  299.   5) Create an AUTOEXEC.BAT file.  The file should contain the following
  300.      lines:
  301.  
  302.      PATH=A:\;
  303.      IPX
  304.      NET3
  305.      JSERVER fileservername jobservername
  306.  
  307.      where "fileservername" is the name of the file server on which you
  308.      are installing the job server and "jobservername" is the name you
  309.      assigned to the the job server in steps 5 & 6 of SETUP.
  310.  
  311.      THE PATH STATEMENT IN THE AUTOEXEC FILE IS ESSENTIAL IN THIS VERSION
  312.      OF THE JOB SERVER.
  313.  
  314.   6) Install a dedicated workstation to act as the job server, if this has
  315.      not already been done.
  316.  
  317.   7) Boot the dedicated workstation acting as the job server from the job
  318.      server boot diskette created in steps 1-5 above.
  319.  
  320.  
  321.   The job server should boot up and indicate it has attached to any job
  322.   queues it has been assigned to service.  The job server will then begin
  323.   polling it's assigned queues.  A bar will grow and shrink across the
  324.   bottom of the screen while the job server is idle.  (See TECHNICAL
  325.   INFORMATION below for more information).
  326.  
  327.   Hitting any key on the keyboard will cause the job server to detach from
  328.   its assigned job queues and exit.  This will happen immediately if it is
  329.   idle and upon completion of the current job if it is processing.
  330.  
  331.  
  332. JOB SUBMISSION:
  333.  
  334.   JSEXEC.EXE is the facility by which queue users place jobs in a queue for
  335.   processing by the job server.  Type JSEXEC at the DOS command line and
  336.   press <Enter>.  The following usage information will be output to the
  337.   screen:
  338.  
  339.  
  340. ┌─────────────────────────────────────────────────────────────────────────────┐
  341. │                                                                             │
  342. │  BobWare Job Server Execution  v1.1.                                        │
  343. │  Copyright (c) 1990 by Campbell's Software, Inc.  All Rights Reserved.      │
  344. │                                                                             │
  345. │   Usage:                                                                    │
  346. │                                                                             │
  347. │     JSEXEC [-flag=value] . . . [-flag=value] <d:\path\filename>             │
  348. │                                                                             │
  349. │     Where <d:\path\filename> represents any valid network drive, path,      │
  350. │     file specification, and [-flag=value] represents any of the optional    │
  351. │     flags and associated values listed below.  Arguments may follow the     │
  352. │     filename specification.                                                 │
  353. │                                                                             │
  354. │                                                                             │
  355. │   Valid Flags:                                                              │
  356. │                                                                             │
  357. │     -s=<target job server name>         -q=<target queue name>              │
  358. │     -d=<execution date mm/dd/yy>        -t=<execution time hh:mm:ss>        │
  359. │     -c=<job comment (30 chars)>         -r <repeat execution daily>         │
  360. │     -w <repeat execution weekly>        -n <completion notification>        │
  361. │                                                                             │
  362. │  Example:  JSEXEC -q=queue1 -d=02/03/91 -t=18:00:00 compile program1.cob    │
  363. │                                                                             │
  364. └─────────────────────────────────────────────────────────────────────────────┘
  365.  
  366.     Figure 1.  In the example above  "compile program1.cob"  will be placed
  367.                in job queue "queue1" and will not execute before February 3,
  368.                1991 at 6:00 pm.
  369.  
  370.  
  371.  
  372.   To place a job in the queue for processing type JSEXEC at the DOS prompt
  373.   followed by any flags you wish to include and the DOS command line you
  374.   wish to be placed in a queue for execution, separated by spaces.  Notice
  375.   that each flag is preceded by a dash ( - ) and those requiring a value
  376.   are immediately followed by and equals sign ( = ) and then the value.
  377.  
  378.   No spaces should separate the dash, the flag itself, the equals sign, or
  379.   the value.  All flags must precede the DOS command line statement.
  380.  
  381.   The -q=<target queue name> is the only required flag.  Optional flags
  382.   allow you to select a specific job server for processing, an execution
  383.   date before which the job will not be processed, an execution time before
  384.   which the job will not be processed, a comment which will appear in the
  385.   JSCON queue display and log display.  Flags are also included to allow
  386.   you to schedule jobs to run daily or weekly after their first execution
  387.   date and time.  The final flag allows you to request the job server to
  388.   send a NetWare broadcast message back to you at the completion of a job's
  389.   execution.
  390.  
  391.  
  392. JOB MONITORING:
  393.  
  394.   Type JSCON at the DOS prompt and press <Enter> (This is the same utility
  395.   used during the setup process).  Select "Job Queue Information" from the
  396.   menu.  Select the queue name you wish to interrogate from the "Defined
  397.   Job Queues" window.  Select "Currently Queued Jobs" from the "Queue
  398.   Information" menu.
  399.  
  400.   A list of currently queued jobs will be presented.  Each job will have a
  401.   status of "Adding", "Ready", or "Active" at the far right of each entry.
  402.   You will rarely if ever see a job status "Adding", most will be "Ready",
  403.   waiting for execution, and jobs currently executing will be "Active".
  404.   Since the job server can process one job at a time, the number of "Active"
  405.   jobs is limited to the number of job servers assigned to the queue.
  406.  
  407.   Move through the job entries by using <up arrow>, <down arrow>, <Page Up>,
  408.   <Page Down>, <Home>, and <End> keys.
  409.  
  410.   If you wish to delete one of your own jobs, highlight the job to delete
  411.   and press the <Delete> key.  You will be asked to comfirm your request.
  412.   Select "Yes" to confirm the deletion.  Select "No" or press <Esc> to
  413.   cancel the request.
  414.  
  415.   There are two (2) things of which you should be aware.  1) Queue users can
  416.   delete jobs they have placed in the queue.  Queue operators can delete any
  417.   job.  2) If you delete an "Active" job it will continue to execute on the
  418.   dedicated job server machine.  The only way to abort a job is to reboot the
  419.   job server machine itself.
  420.  
  421.  
  422.   Additional information about a job queue can be obtained from the "Attached
  423.   Servers" and "Queue Status" selections of the "Queue Information" menu.
  424.   "Attached Servers" simply displays all job servers currently attached to
  425.   the job queue being interrogated.  "Queue Status" will display the queue's
  426.   internal NetWare Id, the number of jobs in the queue, and the number of job
  427.   servers attached to the queue.  It will also indicate if users are allowed
  428.   to add jobs to the queue, if job servers are allowed to service jobs in the
  429.   queue, and if job servers are allowed to attach to the queue.
  430.  
  431.  
  432. LOG MAINTENANCE:
  433.  
  434.  
  435.   Type JSCON at the DOS prompt and press <Enter> (This is the same utility
  436.   used during the setup process).  Select "Job Queue Information" from the
  437.   menu.  Select the queue name you wish to interrogate from the "Defined
  438.   Job Queues" window.  Select "Completed Jobs" from the "Queue
  439.   Information" menu.
  440.  
  441.   A list of your completed jobs will be presented.  Each job will have a
  442.   status of "Normal" or a DOS return code at the far right of each entry.
  443.  
  444.   Move through the log entries by using <up arrow>, <down arrow>, <Page Up>,
  445.   <Page Down>, <Home>, and <End> keys.
  446.  
  447.   If you wish to view job execution output, highlight the job to view
  448.   and press the <Enter> key.  You will be presented with a display of all
  449.   of the video output the job server could capture during processing.
  450.   (See TECHNICAL INFORMATION for information on limitations).
  451.  
  452.   If you wish to print a completed job's video output file, highlight the
  453.   job to print and press <Shift><F7>.  The video output file will be directed
  454.   to LPT1.  Use the NetWare CAPTURE command if you wish to direct this output
  455.   to a network printer.  <Shift><F7> will also print the video output file
  456.   if you are currently viewing it.
  457.  
  458.   If you wish to delete one of your log files, highlight the entry to delete
  459.   and press the <Delete> key.  You will be asked to comfirm your request.
  460.   Select "Yes" to confirm the deletion.  Select "No" or press <Esc> to
  461.   cancel the request.
  462.  
  463.   There are two (2) things of which you should be aware.  1) Video output
  464.   files with more than 4096 lines in them can not be viewed correctly,
  465.   however you should be able to print them with no problem.  2) Along with
  466.   the video output of a job, the last video output screen of execution is
  467.   captured to the video output file.  This is the last 25 lines of the file.
  468.  
  469.  
  470. THE QUEUE OPERATOR:
  471.  
  472.   A queue operator can monitor and maintain the queue and log files of any
  473.   queue user.  Keep in mind that a queue operator is not automatically a
  474.   queue user and must be defined as a queue user to be allowed to place jobs
  475.   in a specific queue.
  476.  
  477.  
  478.   Queue monitoring is identical to that of a queue user.
  479.  
  480.   To maintain log files for queue users other that yourself go to the
  481.   completed jobs display as described above. Press <F9>.  You will be
  482.   presented with a list of all users who have output logs for the queue
  483.   you are currently interrogating.  Highlight the appropriate user and press
  484.   <Enter>.  You will be presented with the selected user's log entries.
  485.   Operation will then be identical to that described above.
  486.  
  487.   A user will not appear in the "Queue Log Users" window until at least one
  488.   job has been processed on their behalf.
  489.  
  490.   To delete all of a user's log files press <F9> from the log entry display.
  491.   Highlight the user whose log you wish to delete and press the <Delete> key.
  492.   You will be asked to comfirm your request.  Select "Yes" to confirm the
  493.   deletion.  Select "No" or press <Esc> to cancel the request.
  494.  
  495.   A queue operator also has the ability to globally control access to a queue
  496.   by queue users and queue servers.  Select "Queue Status" from the "Queue
  497.   Information" menu.  Pressing "N" or "Y" in the last three entries in the
  498.   window will disable or enable, respectively, user or job server access
  499.   to the queue as indicated.
  500.  
  501.  
  502. ADDITIONAL QUEUES & SERVERS:
  503.  
  504.   To set up additional job queues and job servers follow the appropriate
  505.   steps in the SETUP section above.  A single job server can service up to
  506.   25 job queues.  A single job queue can be serviced by any number of job
  507.   servers.
  508.  
  509.  
  510. TECHNICAL INFORMATION:
  511.  
  512.   The following information is included to help you understand this product
  513.   from a technical point of view.  It could be helpful in solving problems
  514.   you may encounter (hopefully there will not be any) and give you insight
  515.   into network resources utilized by this product.
  516.  
  517.   This product is based on Novell's Queue Management APIs.  Extensive use
  518.   is also made of a number Novell's other APIs, including Bindery Services,
  519.   Connection Services, File Server Services, Directory Services, File
  520.   Services, and Message Services.
  521.  
  522.   All job queue, job server, queue user, queue operator, and queue server
  523.   information is stored in the NetWare bindery.  Files necessary to setup
  524.   job queues and job queue logs are stored in subdirectories of the SYSTEM
  525.   directory on the SYS volume of your network.
  526.  
  527.  
  528.   Each job server you install will require a connection on the file server
  529.   where you install it, while it is operating.  To confirm this use NetWare's
  530.   FCONSOLE utility and go to "Connection Information".  While the job server
  531.   is operating, but idle, it will appear under its own assigned name in the
  532.   "Current Connections" window.  While processing a job its connection will
  533.   appear under the name of the client who requested the processing.  If you
  534.   have limited the number of connections for a user and the job server is
  535.   processing a job on behalf of this user, the user may not be allowed to log
  536.   in to the file server.  This should have no effect if the user is logged in
  537.   prior to the execution of the job by the job server.
  538.  
  539.   WHILE PROCESSING A JOB ON BEHALF OF A CLIENT THE JOB SERVER'S NetWare
  540.   SECURITY IS CHANGED TO THAT OF THE CLIENT.  ALL DOS ENVIRONMENT VARIABLES
  541.   AND NETWORK DRIVE MAPPINGS ARE ALSO IDENTICAL TO THE CLIENTS AT THE TIME
  542.   THE JOB WAS PLACED IN THE QUEUE.  At the current time NetWare search drive
  543.   mappings are included in the DOS PATH environment variable.  However, these
  544.   are not true NetWare search drives.  This will be corrected in a future
  545.   version.
  546.  
  547.   JSCON currently limits some display window's to a maximum of 256 entries.
  548.   If you have a combined total of more than 256 NetWare Users and Groups
  549.   defined you may encounter problems.
  550.  
  551.   A queue user is allowed to have no more than 255 log entries per job queue.
  552.   If this limited is reached results will be unpredictable.  Deleting entries
  553.   from the log should correct the problem.
  554.  
  555.   As much video output as possible is captured to the queue log video display
  556.   file.  Some applications write directly to video memory, and while it may
  557.   be possible, it is considered impractical to capture this information.  A
  558.   queue log video display file is also limited to 4096 lines for viewing,
  559.   however it should print with no problems.
  560.  
  561.   This product's bindery definition of Job Servers and Job Queue follows
  562.   Novell's convention for NetWare bindery object types.  It is possible
  563.   that other products may use the same convention.  If this product finds
  564.   job servers or job queues in the bindery that have not been defined by
  565.   this product it will display them.  However, they will not function
  566.   properly.
  567.  
  568.   A job server could constantly poll job queues looking for jobs to process.
  569.   However, this would put unnecessary stress on the file server.  The polling
  570.   scheme used for this product could cause a delay in processing of up to
  571.   30 seconds after the time a job is placed in a job queue.  While the bar
  572.   on the job server is growing it is waiting to poll its queues for jobs to
  573.   process.  When it reaches its maximum length the polling process will occur.
  574.  
  575.   Keep in mind the job server is almost identical to a user workstation.  To
  576.   abort a job the job server must be rebooted, or the job must be aborted in
  577.   in some other way at the dedicated job server machine.  If a job that
  578.   requires keyboard input is placed in the queue, keyboard input must be
  579.   supplied at the dedicated job server machine when the job is processed.
  580.  
  581.   At the current time the job server uses approximately 70K of additional
  582.   memory while processing jobs.  This will be reduced in the future.
  583.  
  584.   The "Change Current Server" option on the "Available Options" of JSCON
  585.   will allow you to change file servers.  However you must already be logged
  586.   into or attached to additional file servers before entering JSCON.
  587.  
  588.  
  589. ORDER INFORMATION:
  590.  
  591.   In its infancy this product was developed out of curiosity.  It was then
  592.   developed to satisfy a specific need.  After realizing it could have
  593.   a commercial impact it was completely rewritten as a generic job server
  594.   product.  We now consider it to be in it's full blown adolescence and ready
  595.   to enter the real world.  With your input we can bring it to its maturity.
  596.  
  597.   Our desire at this time is to fill a hole we believe to exist in the NetWare
  598.   environment and most of all to please our customers.  This software is a
  599.   demonstration only.  If you find it to be beneficial to your organization
  600.   we hope you will order a licensed copy during the demonstration period of
  601.   90 days.  Below we have listed the information necessary to obtain a licensed
  602.   copy.  We are currently able to accept only checks or money orders.
  603.  
  604.   If you decide to order now, you will receive the next update free of
  605.   charge.
  606.  
  607.  
  608.   Future versions are expected to contain the following:
  609.  
  610.             1) Online Help
  611.             2) Reduced Memory Requirements On The Job Server
  612.             3) True NetWare Search Drive Mappings
  613.             4) Any Suggestions You May Have, Which We Deem Practical
  614.  
  615.  
  616.   These are subject to change and are somewhat dependent on your responses.
  617.  
  618.  
  619.  
  620.   To order:
  621.  
  622.      Print, fill out and return the ORDER.DOC file included with this
  623.      demonstration package.
  624.  
  625.      Mail order form to:
  626.  
  627.          Campbell's Software Inc.
  628.          10831 West Broad Street, Suite 217
  629.          Glen Allen, VA  23060
  630.  
  631.  
  632.      Make checks or money orders payable to:
  633.  
  634.          Campbell's Software Inc.
  635.  
  636.  
  637.   Licenses are on a per file server basis.
  638.  
  639.   Site licenses for the BobWare Job Server are available.  Write Campbell's
  640.   Software Inc. for more information.
  641.  
  642.   Questions and comments can be sent to Campbell's Software Inc. at the above
  643.   address or directed to:
  644.  
  645.       CompuServe ID  75360,352  or 73167,3405
  646.  
  647.  
  648. DISCLAIMER:
  649.  
  650.   Campbell's Software Inc. hereby disclaims all warranties relating to this
  651.   software, whether express or implied, including without limitation any
  652.   implied warranties of merchantability or fitness for a particular purpose.
  653.   Campbell's Software Inc. will not be liable for any special, incidental,
  654.   consequential, indirect or similar damages due to loss of data or any other
  655.   reason, even if Campbell's Software Inc. or an agent of Campbell's Software
  656.   Inc. has been advised of the possibility of such damages.  In no event shall
  657.   Campbell's Software Inc.'s liability for any damages ever exceed the price
  658.   paid for the license to use software, regardless of the form of the claim.
  659.   The person using the software bears all risk as to the quality and
  660.   performance of the software.
  661.  
  662.  
  663.   NetWare is a registered trademark of Novell Inc.
  664.